Enables software license or feature pack that allows you to use advanced features.
| software | Applies base license. |
| key | Specifies your hexadecimal license key in format xxxx-xxxx-xxxx-xxxx-xxxx (10 hex digits) or xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx (14 hex digits). |
N/A.
The software license levels that apply to ExtremeXOS software are described in the Switch Engine v33.1.1 Licensing Guide document.
To obtain a software license, specify the key in the format xxxx-xxxx-xxxx-xxxx-xxxx.
You obtain the software license key (or feature pack key) either by ordering it from the factory or by obtaining a license voucher from your Extreme Networks supplier. You can obtain a regular software license or a trial software license, which allows you use of the license for either 30, 60 or 90 days; you cannot downgrade software licenses.
The voucher contains all the necessary information on the software license, whether regular or trial, and number of days for trial software license.
After you enable the software license or feature pack by entering the software key, the system returns a message that you either successfully or unsuccessfully set the license.
Once you enable the software license (or if you do not use the correct key, attempt to downgrade the license, or already installed the software license) you see one of the following messages:
Enabled license successfully. Error: Unable to set license using supplied key. Error: Unable to set license - downgrade of licenses is not supported. Error: Unable to set license - license is already enabled. Error: Unable to set license - trial license already enabled.
If you enable a trial license, the system generates a daily message showing the number of days until expiry.
If you attempt to execute a command and you do not either have the required software license or have reached the limits defined by the current software license level, the system returns one of the following messages:
Error: This command cannot be executed at the current license level. Error: You have reached the maximum limit for this feature at this license level.
If you attempt to execute a command and you do not have the required feature pack, the system also returns a message.
To protect against attacks to install maliciously created license keys, the system has an exponential delay of each failed attempt to install a license.
To view the type of software license you are currently running on the switch, use the show licenses command. The license key number is not displayed, but the type of software license is displayed in the show licenses output. This command can be run on any node in a SummitStack, regardless of its node role (master, standby, or backup).
"Error: Incorrect key format."
Error: Unable to set license - platform incompatible with license.
Error: Unable to set license - platform only supports ports in range 1 to <max for platform>.
Error: Unable to set license. Read from EEPROM failed.
Error: Unable to set license - license is already enabled.
Error: Unable to set license - downgrade of port speed license not supported. <num_ports> ports already licensed. Current license can be cleared via 'clear license-info port-speed'.
Error: Unable to set license - write to EEPROM failed.
The following command enables a software license on the switch:
enable license 2d5e-0e84-e87d-c3fe-bfff
Warning: A reboot switch or disable and enable slot 3 is required before the new license takes effect.
This command was first available in ExtremeXOS 11.1.
The software parameter was added in ExtremeXOS 11.6.
The capacity-key variable was added in ExtremeXOS 15.4.
The capacity-key variable was removed in ExtremeXOS 22.2.
This command is available on all Universal switches supported in this document.